ch.randelshofer.quaqua.filechooser
Class WindowsFileSystemView

java.lang.Object
  javax.swing.filechooser.FileSystemView
      ch.randelshofer.quaqua.filechooser.FileSystemViewFilter
          ch.randelshofer.quaqua.filechooser.QuaquaFileSystemView
              ch.randelshofer.quaqua.filechooser.WindowsFileSystemView

public class WindowsFileSystemView
extends QuaquaFileSystemView

WindowsFileSystemView provides a Aqua-style view on the windows file system.

Version:

1.1 2005-12-09 Moved from ch.randelshofer.quaqua.metal.filechooser package into ch.randelshofer.quaqua.filechooser package.
1.0 August 26, 2005 Created.

Author:

Werner Randelshofer

Field Summary

Fields inherited from class ch.randelshofer.quaqua.filechooser.FileSystemViewFilter

target

Constructor Summary

WindowsFileSystemView()
Creates a new instance.

Method Summary

java.io.File	getChild(java.io.File parent, java.lang.String fileName)
java.io.File	getComputer() Returns the file that represents this computer node.
java.io.File	getDefaultDirectory() Return the user's default starting directory for the file chooser.
java.io.File	getHomeDirectory()
java.io.File[]	getRoots() Returns all root partitions on this system.
java.lang.String	getSystemDisplayName(java.io.File f) Name of a file, directory, or folder as it would be displayed in a system file browser.
javax.swing.Icon	getSystemIcon(java.io.File f) Icon for a file, directory, or folder as it would be displayed in a system file browser.
java.lang.String	getSystemTypeDescription(java.io.File f) Type description for a file, directory, or folder as it would be displayed in a system file browser.
java.io.File	getSystemVolume() Returns the file that represents the system (boot) volume of this computer.
boolean	isComputerNode(java.io.File dir) Used by UI classes to decide whether to display a special icon for a volumesFolder node, e.g.
boolean	isDrive(java.io.File dir) Used by UI classes to decide whether to display a special icon for drives or partitions, e.g.
boolean	isFileSystem(java.io.File f) Checks if f represents a real directory or file as opposed to a special folder such as "Desktop".
boolean	isFileSystemRoot(java.io.File dir) Is dir the root of a tree in the file system, such as a drive or partition.
boolean	isFloppyDrive(java.io.File dir) Used by UI classes to decide whether to display a special icon for a floppy disk.
boolean	isParent(java.io.File folder, java.io.File file) On Windows, a file can appear in multiple folders, other than its parent directory in the filesystem.
boolean	isRoot(java.io.File f) Determines if the given file is a root in the navigatable tree(s).
java.lang.Boolean	isTraversable(java.io.File f) Returns true if the file (directory) can be visited.

Methods inherited from class ch.randelshofer.quaqua.filechooser.QuaquaFileSystemView

createFileView, getQuaquaFileSystemView

Methods inherited from class ch.randelshofer.quaqua.filechooser.FileSystemViewFilter

createFileObject, createFileObject, createNewFolder, getFiles, getParentDirectory, isHiddenFile

Methods inherited from class javax.swing.filechooser.FileSystemView

createFileSystemRoot, getFileSystemView

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WindowsFileSystemView

public WindowsFileSystemView()

Creates a new instance.

Method Detail

getComputer

public java.io.File getComputer()

Description copied from class: QuaquaFileSystemView

Returns the file that represents this computer node.

Specified by:

getComputer in class QuaquaFileSystemView

getSystemVolume

public java.io.File getSystemVolume()

Description copied from class: QuaquaFileSystemView

Returns the file that represents the system (boot) volume of this computer.

Specified by:

getSystemVolume in class QuaquaFileSystemView

getRoots

public java.io.File[] getRoots()

Returns all root partitions on this system. For example, on Windows, this would be the "Desktop" folder, while on DOS this would be the A: through Z: drives.

Overrides:

getRoots in class FileSystemViewFilter

isTraversable

public java.lang.Boolean isTraversable(java.io.File f)

Returns true if the file (directory) can be visited. Returns false if the directory cannot be traversed.

Specified by:

isTraversable in class FileSystemViewFilter

Parameters:

f - the File

Returns:

true if the file/directory can be traversed, otherwise false

See Also:

JFileChooser.isTraversable(java.io.File), FileView.isTraversable(java.io.File)

getSystemDisplayName

public java.lang.String getSystemDisplayName(java.io.File f)

Name of a file, directory, or folder as it would be displayed in a system file browser. Example from Windows: the "M:\" directory displays as "CD-ROM (M:)" The default implementation gets information from the ShellFolder class.

Specified by:

getSystemDisplayName in class FileSystemViewFilter

Parameters:

f - a File object

Returns:

the file name as it would be displayed by a native file chooser

See Also:

JFileChooser.getName(java.io.File)

getSystemTypeDescription

public java.lang.String getSystemTypeDescription(java.io.File f)

Type description for a file, directory, or folder as it would be displayed in a system file browser. Example from Windows: the "Desktop" folder is desribed as "Desktop". Override for platforms with native ShellFolder implementations.

Specified by:

getSystemTypeDescription in class FileSystemViewFilter

Parameters:

f - a File object

Returns:

the file type description as it would be displayed by a native file chooser or null if no native information is available.

See Also:

JFileChooser.getTypeDescription(java.io.File)

getSystemIcon

public javax.swing.Icon getSystemIcon(java.io.File f)

Icon for a file, directory, or folder as it would be displayed in a system file browser. Example from Windows: the "M:\" directory displays a CD-ROM icon. The default implementation gets information from the ShellFolder class.

Specified by:

getSystemIcon in class FileSystemViewFilter

Parameters:

f - a File object

Returns:

an icon as it would be displayed by a native file chooser

See Also:

JFileChooser.getIcon(java.io.File)

isParent

public boolean isParent(java.io.File folder,
                        java.io.File file)

On Windows, a file can appear in multiple folders, other than its parent directory in the filesystem. Folder could for example be the "Desktop" folder which is not the same as file.getParentFile().

Specified by:

isParent in class FileSystemViewFilter

Parameters:

folder - a File object repesenting a directory or special folder

file - a File object

Returns:

true if folder is a directory or special folder and contains file.

getChild

public java.io.File getChild(java.io.File parent,
                             java.lang.String fileName)

Specified by:

getChild in class FileSystemViewFilter

Parameters:

parent - a File object repesenting a directory or special folder

fileName - a name of a file or folder which exists in parent

Returns:

a File object. This is normally constructed with new File(parent, fileName) except when parent and child are both special folders, in which case the File is a wrapper containing a ShellFolder object.

isFileSystem

public boolean isFileSystem(java.io.File f)

Checks if f represents a real directory or file as opposed to a special folder such as "Desktop". Used by UI classes to decide if a folder is selectable when doing directory choosing.

Specified by:

isFileSystem in class FileSystemViewFilter

Parameters:

f - a File object

Returns:

true if f is a real file or directory.

isFileSystemRoot

public boolean isFileSystemRoot(java.io.File dir)

Is dir the root of a tree in the file system, such as a drive or partition. Example: Returns true for "C:\" on Windows 98.

Specified by:

isFileSystemRoot in class FileSystemViewFilter

Parameters:

dir - a File object representing a directory

Returns:

true if f is a root of a filesystem

See Also:

isRoot(java.io.File)

isDrive

public boolean isDrive(java.io.File dir)

Used by UI classes to decide whether to display a special icon for drives or partitions, e.g. a "hard disk" icon. The default implementation has no way of knowing, so always returns false.

Specified by:

isDrive in class FileSystemViewFilter

Parameters:

dir - a directory

Returns:

false always

isFloppyDrive

public boolean isFloppyDrive(java.io.File dir)

Used by UI classes to decide whether to display a special icon for a floppy disk. Implies isDrive(dir). The default implementation has no way of knowing, so always returns false.

Specified by:

isFloppyDrive in class FileSystemViewFilter

Parameters:

dir - a directory

Returns:

false always

isComputerNode

public boolean isComputerNode(java.io.File dir)

Used by UI classes to decide whether to display a special icon for a volumesFolder node, e.g. "My Computer" or a network server. The default implementation has no way of knowing, so always returns false.

Specified by:

isComputerNode in class FileSystemViewFilter

Parameters:

dir - a directory

Returns:

false always

getHomeDirectory

public java.io.File getHomeDirectory()

Overrides:

getHomeDirectory in class FileSystemViewFilter

getDefaultDirectory

public java.io.File getDefaultDirectory()

Return the user's default starting directory for the file chooser.

Specified by:

getDefaultDirectory in class FileSystemViewFilter

Returns:

a File object representing the default starting folder

isRoot

public boolean isRoot(java.io.File f)

Description copied from class: FileSystemViewFilter

Determines if the given file is a root in the navigatable tree(s). Examples: Windows 98 has one root, the Desktop folder. DOS has one root per drive letter, C:\, D:\, etc. Unix has one root, the "/" directory. The default implementation gets information from the ShellFolder class.

Overrides:

isRoot in class FileSystemViewFilter

Parameters:

f - a File object representing a directory

Returns:

true if f is a root in the navigatable tree.

See Also:

FileSystemViewFilter.isFileSystemRoot(java.io.File)